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TrueSync Developer's Guide 

Section 3: Interface Method Descriptions 

Introduction 

This section of the Developers Guide discusses in detail the interface methods that a programmer 
needs to satisfy when implementing an accessor or conduit. 

Note that the syncCore . dil implementation of the SyncCore logic only requires the use of the 
SyncCoreUStore and ConduitKitUInserter interfaces. The AccessKitUAccessStore 
interface used inbound between the conduit and the accessors is optional and assumes the use of data 
storage classes from ToolKit. This is also true of the implementation base class 

ConduitKit\Trans former. 

Note that during the outbound phase, the store is the one and only interface object that is 
instantiated. 

Interface List 

• IStore (outbound & inbound) 

• IStore (outbound only) 

• IStore (inbound only) 

• IAccessStore (source & target) 

• IAccessStore (source only) 

• IAccessStore (target only) 



IStore (outbound & inbound) 

void destroy O 

A request to delete the object. Usually implemented inline as { delete this ; j . 

int open(ISyncInfb& info, int mode) 
int close O 

open (...) is a request to open the dataset and the record map. Configuration information may 
be retrieved from isyncinf o. The dataset mode is read for outbound processing and write 
for inbound processing. 

close () is a request to close the dataset and the record map. 
Return non-zero for success and zero for failure. 

IRecordMapft map() 
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A request for the record map. Your store must instantiate a class using the 
AccessKit\TRecordMap template. See the header file for details. 

int moveRecordToFromMapO 

An instruction to locate in the dataset the record that corresponds to the "current" record in the 
RecordMap. Called outbound during delete order generation and inbound for both deletes and 
exports. The current record in the RecordMap is retrieved with the method MapEntryExts 
TRecordMap : : current ( ) . 

Return non-zero for success and zero for failure. If the record is located, it should be made the 
"current" record in the store. This is usually accomplished by keeping a copy of the record in 
memory. 

time_t recordModifyTimeO 



A query for the store's "current" record last modified timestamp. 



IStore (outbound only) 

int extractByDate(time_t t) 

A request to prepare for outbound export record generation. The parameter is the time of the 
last outbound synchronization with the target dataset. This method allows large datasets to 
limit the number of records extracted for processing. After this call the extracted recordset is 
assumed ready for iteration. Return non-zero for success and zero for failure. 

int isEmptyO 
int isEOF () 

Queries about the state of extraction iteration. Called during export generation. isEmpty ( ) 
should return non-zero if there are records to iterate over. isEOF ( ) should return non-zero if 
iteration has traversed all records in the extracted set. The Outsynchronizer logic does not 
require multiple or reverse iteration of the extract set. 

void moveRecordFirstO 
void moveRecordNext Q 

Instructions to iterate through the extracted records. Called during export generation. The 
record moved to becomes the "current" record in the store. 



MapEntryExt * moveEntryToFromStore () 
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An instruction to locate in the RecordMap the entry that corresponds to the "current" record in 
the store. Called during export generation. Use the call 

TRecordMap: :moveToint (MAP_entry_int& ) . Return the located entry or null if not found. 
MapEntryExtfc addToMapForExport O 

An instruction to add an entry into the RecordMap containing the store's current record 
internal identifier and timestamp. Called during export generation. Use the call 

TRecordMap : : addExport (MAP_ENTRY_INT& , cons t CTime& ) . Return the new map entry, 
int filterForExport() 

The store may perform filtering to block certain records from being exported. Called during 
export generation. Return non-zero to pass the record and zero to block it. 

void sendSchema(CArchive& ar) 

A request to serialize the store's schema into the passed MFC archive. This request may be 
ignored if the schema is fixed, like Intera. Called during export generation, before record 
serialization. 

The format is completely at the discretion of the store, although the 

TooiKit \FieldDirectory class is available for describing an arbitrary schema. 

void sendRecord(CArchive& ar) 

A request to serialize the store's "current" record into the passed MFC archive. The format is 
completely at the discretion of the store, although the TooiKitNFieidDirectory class is 
available for describing an arbitrary data structure. Called during export generation. 

Return to Interface List 



IStore Interface (inbound only) 

MapEntryExtft addToMapForImport(MapEntryExt& entryExt, time_t timestamp) 

An instruction to add an entry into the RecordMap containing the store's current record 
internal identifier and the passed MapEntryExt and timestamp. Called after a record is 
inserted into the Store. Use the call TRecordMap: : addimport (map_entry_int&, 
MapEntryExts , time _t ) . Return the new map entry. 



void removeRecordQ 
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Instruction to remove the store 
processing. 



Return to 



lAccessStore Interface (source & target) 



A request to delete the object. Usually implemented inline as { delete this; } 



(source only) 

ITransflalfS recvSchema(CArchive& ar) 



store's schema out of the passed MFC archive. The serialization 
request may be ignored if the schema was not serialized outbound. Called if the 
schema is found while SyncSet. 

ToolKitVTransHalf object describing the schema. A consists of a last-modified 

timestamp and two , one for the schema and one for the 

"current" TransHalf and header files. 

If you want to use the interface you need to become familiar with the building 

blocks of , namely Fields FieldArrays. 



A request to create or overwrite the store 

passed MFC archive. Called if a record is found while reading the 

Return to 

lAccessStore Interface (target only) 

ITransHalf* getSchema() 
void fetchTgtFieldsO 

void acceptRecord (const ITransHalfifc th) 
int filterForDeleteQ 
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int filterForInsert() 
time_t insertRecordQ 
tirae_t updateRecordQ 



